package com.yootk.service;

import com.yootk.vo.Member;

import java.util.List;
import java.util.Map;

/**
 * 业务层接口
 */
public interface IMemberService {
    /**
     * 实现用户数据的添加操作，在进行数据添加时需要考虑到如下的业务验证：
     * 1、【程序逻辑】判断输入的年龄是否符合要求；
     * 2、【程序逻辑】判断输入的性别是否符合要求；
     * 3、【数据层】检测输入的用户名（mid）数据是否重复，如果重复则不能够进行注册；
     * 4、【数据层】检测输入的Email数据是否重复，如果重复则不能够进行注册；
     * 5、【数据层】没有任何的数据验证问题，则执行数据增加操作。
     * @param vo 包含有要增加的数据内容
     * @return 数据增加成功返回true，否则返回false
     * @throws Exception 业务有关的异常，正常的设计应该是做一些自定义的业务异常，本次简化操作
     */
    public boolean add(Member vo) throws Exception;

    /**
     * 实现用户数据的更新处理，本次的更新是根据ID修改全部字段的内容，该操作需要执行如下业务逻辑：
     * 1、【程序逻辑】判断输入的年龄是否符合要求；
     * 2、【程序逻辑】判断输入的性别是否符合要求；
     * 3、【数据层】判断更新后的email地址是否与其他的用户email相同
     * 4、【数据层】执行数据更新处理操作
     * @param vo 要更新全部数据的内容
     * @return 更新成功返回true，否则返回false
     * @throws Exception 抛出业务异常
     */
    public boolean edit(Member vo) throws Exception;

    /**
     * 根据id实现数据的删除，在进行删除的时候需要执行如下的业务逻辑检测：
     * 1、【程序逻辑】判断是否存在有要删除的数据内容（数组长度是否大于0）
     * 2、【数据层】根据id进行数据的删除
     * @param ids 要删除的用户id集合
     * @return 删除成功返回true，否则返回false
     * @throws Exception 抛出业务异常
     */
    public boolean removeById(String... ids) throws Exception;

    /**
     * 根据ID获取一个用户的完整信息
     * @param id 要查询的id
     * @return 数据以VO对象实例的形式返回，如果数据不存在则返回null
     * @throws Exception 抛出业务异常
     */
    public Member get(String id) throws Exception;

    /**
     * 实现用户的全部列表显示
     * @return 用户的数据集合，如果没有任何的用户数据信息则列表长度为0（size()==0，不是null）
     * @throws Exception 抛出业务异常
     */
    public List<Member> list() throws Exception;

    /**
     * 实现用户数据的分页列表显示，也同时支持有数据的模糊查询
     * @param currentPage 当前所在页
     * @param lineSize    每页显示的数据行数
     * @param column      模糊查询列
     * @param keyword     查询关键字
     * @return 数据的查询结果，该结果通过Map集合描述，在集合中保存有如下的数据内容：
     * 1、key = allMembers、value = List集合，所有的查询结果；
     * 2、key = allRecorders、value = Long统计结果（count()统计函数）
     * @throws Exception 抛出业务异常
     */
    public Map<String, Object> split(Integer currentPage, Integer lineSize, String column, String keyword) throws Exception;
}
